Micron Document

Interface
Part 3/6 • 18.6 KB total
──────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────
The tools Reticulum Announce Propagation Simulator and Reticulated may be used to visualize how announces propagate.

In RNS, you can disable announce propagation from internal interfaces to a specific interface by setting announces_from_internal = false on that interface. Paths to destinations on internal interfaces may still be resolved via the interface if it provides path seeking.

Setting announces_to_internal = true on a boundary interface will allow announce propagation from that interface to any internal interfaces. Likewise, autoconnect_announces_to_internal = true does the same for auto-connected interfaces if autoconnect_interface_mode = boundary.

Path seeking

See also: Path#Request

Any node that has no path to a destination can send out a path request on the network. An interface that supports path seeking will attempt to recursively resolve path requests it receives. See the comparison table above for which interface modes support path seeking by default.

In RNS, it is possible to force path seeking on individual boundary and full interfaces by setting recursive_prs = true.

Note: In the manual and code, this is sometimes called "path discovery". On this wiki, the term "path seeking" is used to avoid confusion with interface discovery.

Discoverable

See also: Discovery

By making an interface discoverable, other peers can discover, verify, and auto-connect to it. Discoverable interfaces periodically broadcast announce packets with connection details, which are propagated over the network. The announce can be encrypted with a network identity, ensuring the interface is only discoverable on trusted networks. It can also include the interface's IFAC.cite-ref-6[6]

In RNS, to make an interface discoverable, set discoverable = true in its definition. For more, see Discovery Parameters ↗ in the manual.

Note: A discoverable interface announces its presence, capabilities and (if configured) location to the network. This may have security implications.

──────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────